Перед отслеживанием любых событий Javascript вам необходимо включить наш глобальный фрагмент.
Его можно найти в Settings > Tracking Codes в навигации.
Его можно разместить в любом месте вашей страницы, и он должен быть включен только один раз на страницу.
Отслеживание событий конверсии
Во-первых, обратите внимание, что наш глобальный фрагмент, предоставленный в разделах источника предложения и предложения, уже содержит код события конверсии.
Если ваша страница является страницей благодарности, где вам не важно отслеживать просмотр, а только конверсию, вы можете использовать этот фрагмент для этого.
Этот код содержит заполнители для дохода от конверсии и идентификатора транзакции.
Оба эти параметра являются необязательными -- если вы не передаете значение дохода, будет использоваться значение по умолчанию для предложения. При использовании партнерской сети вы обычно используете источник предложения для внедрения динамических идентификаторов выплат/транзакций в код (хотя предпочтительнее использовать URL обратного вызова).
Примечание: во фрагменте, который вы получаете, в зависимости от источника предложения, будут значения в ВЕРХНЕМ РЕГИСТРЕ, которые следует заменить реальными значениями или полностью опустить, если они неизвестны, например, CONVERSION_VALUE и так далее.
Код события Javascript
Базовое событие конверсии может быть запущено с помощью:
flux.track("conversion", { rev:'REVENUE' })Это будет опираться на файлы cookie и текущий URL страницы для определения того, кто является пользователем -- то есть его идентификатора посетителя. Для этого посетителя будет конвертирован самый последний созданный хит предложения.
Это событие может быть успешным только в том случае, если наш универсальный JS-фрагмент уже был включен заранее.
Вы можете использовать этот код для ручного запуска событий, например, при клике на кнопку, отправке формы и т.д. Если вы хотите запустить конверсию при загрузке страницы, включите этот код как есть, но после нашего универсального фрагмента.
Если вы хотите запускать события конверсии после какого-либо клика, отправки и т.д., смотрите этот документ, в котором описывается использование некоторых базовых слушателей событий.
Дополнительные параметры
Дополнительные данные, если они доступны, могут быть внедрены в событие конверсии. Все атрибуты должны передаваться в виде строк.
В событиях конверсии доступны следующие параметры:
rev-- доход, необязательно, в долларах и центах, например, 12.99. Если опущено, используется значение по умолчанию для конвертируемого предложения. Это должно быть передано как строка, поэтому должно быть в кавычках.tx-- идентификатор транзакции, необязательноp-- идентификатор страницы, необязательно, идентификатор предложения (страницы), к которому должна быть привязана конверсия. Часто это не текущая страница, а предыдущая. Если опущено, будет конвертирован самый последний просмотр страницы предложения для сессии пользователяvid-- идентификатор посетителя. Он часто присутствует в URL или куки, но также может быть напрямую внедренhit-- идентификатор хита предложения для конвертации. Обычно это будет не текущая страница, а предыдущая. Если это известно, у вас, вероятно, есть вся информация, необходимая для более надежного серверного обратного вызова. Если вы отправляете hit, вы не должны отправлять vid и наоборот, поскольку они являются идентификаторами пользователя, которые конкурируют (hit более специфичен и будет использоваться).
Например, идентификатор транзакции и известный идентификатор страницы (предложения, с которым связана конверсия):
flux.track("conversion", {
rev:'REVENUE',
tx:'OPTIONAL_TRANSACTION_ID'
p:'PAGE_ID'
})Если система может напрямую внедрить идентификатор хита или посетителя, это также можно сделать, чтобы сделать отслеживание более надежным:
flux.track("conversion", {
rev:'REVENUE',
tx:'OPTIONAL_TRANSACTION_ID',
vid:'VID',
p:'PAGE_ID'
})Атрибут hit также может быть отправлен, хотя обычно, если вы знаете ID хита, вы можете просто вызвать URL обратного вызова вместо этого.
Если известны ID хита и VID, вы можете выбрать отправку одного, а не обоих.
Редко переопределяют время конверсии в JS-запросе, но это возможно, как показано ниже:
flux.track("conversion", { rev:'REVENUE', conversion_time: "unix_timestamp" })Мы рекомендуем использовать метки времени unix, где это возможно, хотя некоторые другие также могут быть обработаны.
Запрос и ответ API
Запрос API будет похож на запрос для событий просмотра, например:
В случае успеха ответ будет содержать идентификатор конверсии, временную метку и показывать идентификатор хита, который был конвертирован, вместе с некоторым контекстом события:
